<HTML>
<HEAD>
  <STYLE type="text/css">
    H1 {color: black }
    H2 {color: maroon }
    H3 {color: #007090 }
    A.head:link {color: #0060a0 }
    A.head:visited {color: #3040c0 }
    A.head:active {color: white }
    A.head:hover {color: yellow }
    A.red:link {color: red }
    A.red:visited {color: maroon }
    A.red:active {color: yellow }
  </STYLE>
</HEAD>
<TITLE>Magic-8.3 Command Reference</TITLE>
<BODY BACKGROUND=graphics/blpaper.gif>
<H1> <IMG SRC=graphics/magic_title8_3.png ALT="Magic VLSI Layout Tool Version 8.3">
     <IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>

<H2>irsim</H2>
<HR>
Invoke the <B>irsim</B> switch-level digital simulator.
<HR>

<H3>Usage:</H3>
   <BLOCKQUOTE>
      <B>irsim</B> [<I>args</I>] <BR><BR>
      <BLOCKQUOTE>
         where <I>args</I> are any arguments to be passed to the <B>irsim</B>
	 program as they would from the command line.  See the <B>irsim</B>
	 documentation for an explanation of its valid command-line
	 arguments.
      </BLOCKQUOTE>
   </BLOCKQUOTE>

<H3>Summary:</H3>
   <BLOCKQUOTE>
      The <B>irsim</B> command starts the <B>irsim</B> simulator.  While
      previous versions of magic did this by forking the <B>irsim</B>
      process, Tcl-based <B>magic</B> can load the Tcl-based <B>irsim</B>
      as a package directly into the interpreter.  Commands for <B>irsim</B>
      are added to the Tcl namespace and are available directly from the the
      <B>magic</B> command line. <P>

      As a Tcl script, the <B>irsim</B> command attempts to set up the
      simulation arguments to ensure proper startup.  It also checks for
      a valid <TT>.sim</TT> file matching the layout, and generates one
      if it does not already exist. <P>

      A number of commands are available for viewing signal values directly
      on the layout.  For a complete description of these commands and
      the Tcl-based <B>irsim</B> simulation environment, see the documentation
      on <B>irsim</B>. <P>
   </BLOCKQUOTE>

<H3>Implementation Notes:</H3>
   <BLOCKQUOTE>
      <B>irsim</B> is implemented as a Tcl procedure that loads the Tcl-package
      based version of <B>irsim</B>, then executes its startup procedure.  The
      <B>irsim</B> Tcl package itself is compiled and installed separately
      from <B>magic</B>.
   </BLOCKQUOTE>

<H3>See Also:</H3>
   <BLOCKQUOTE>
      <A HREF=ext2sim.html><B>ext2sim</B></A> <BR>
   </BLOCKQUOTE>

<P><IMG SRC=graphics/line1.gif><P>
<TABLE BORDER=0>
  <TR>
    <TD> <A HREF=commands.html>Return to command index</A>
  </TR>
</TABLE>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>
